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MediaWiki pour débutants/Configuration de votre wiki 


< MediaWiki pour débutants 


Introduction Installer Utiliser Naviguer Configurer Extensions Fonctions Maintenance Sécuriser Ressources 


Dans cette section, nous allons apprendre les bases de la configuration de MediaWiki et voir comment modifier 
l'apparence générale de votre wiki, afin de l'adapter à votre projet. Pour savoir ce qu'il est possible de faire et vous 
donner des idées, il peut être utile de visiter des wikis : une liste vous est donnée à la fin de cette page. 


Les éléments de configuration que nous allons aborder ne demandent pas de manipulations compliquées. Il faut 
seulement connaître quelques opérations de base, comme copier, enregistrer ou charger un fichier sur un serveur. 
Dans ce qui suit, vous trouverez des lignes dans un langage que vous ne comprendrez peut-être pas : ceci n'est 
pas un obstacle, puisqu'il vous suffira de suivre exactement les étapes des procédures décrites. 


ll existe deux manières générales de configurer votre site : 


e en modifiant en ligne certains paramètres et certaines pages particulières ; 
e en modifiant ou ajoutant des fichiers dans le dossier de votre site. 


Sections 

1 Utiliser des images 
2 Configurer le niveau d'accès à votre wiki 

2.1 Déterminer qui peut éditer ou voir votre wiki 
3 Configurer l'apparence 

3.1 Changer le logo 

3.2 Changer le fond 

3.3 Personnaliser les couleurs 

3.4 Personnaliser la boîte de navigation 

3.5 Ajouter une annonce en haut de toutes les pages 
4 Pour aller plus loin 


Utiliser des images [modifier le wikicode] 


Nous allons tout d'abord rendre possible la copie d'images et de certains fichiers sur votre site : une fois installé, 
MediaWiki ne permet pas de faire de telles copies. Vous devez vous-mêmes en donner l'autorisation. En outre, il 
faut également autoriser le redimensionnement des images pour en maîtriser l'affichage. 


La première chose à faire est d'éditer votre fichier LocalSettings.php avec un éditeur gratuit et libre comme 
NotePad++ (mais pas le Bloc-notes, ni WordPad). Ce fichier contient la configuration générale de votre wiki et il se 
trouve à la racine du dossier de votre wiki. 


Une fois que vous avez ouvert le fichier avec un éditeur de texte, cherchez les lignes suivantes : 


## To enable image uploads, make sure the 'images' directory 
## is writable, then set this to true: 


$wgEnableUploads = false; 
$SwgUselmageResize = false; 

# SwgUselmageMagick = true; 

# SwgImageMagickConvertCommand = "/usr/bin/convert"; 


Et remplacez les false par true, de cette manière : 


## To enable image uploads, make sure the 'images' directory 
## is writable, then set this to true: 


$wgEnableUploads = true; 
SwgUselmageResize = true; 

# SwgUselmageMagick = true; 

# SwgImageMagickConvertCommand = "/usr/bin/convert"; 


Sauvegardez cette modification, et copiez le fichier sur votre site. Ouvrez une page de votre site, et vous aurez, 
dans la boîte à outils à droite de l'écran, un lien Copier une image. 


Mais ceci ne suffit pas pour pouvoir manipuler les images quand elles sont sur votre site ; il faut activer GD pour 
thumb et redimension des images : 


Cette activation peut être réalisée en éditant le fichier php.ini, dans le dossier Apache. Si vous utilisez une 
installation locale, vous avez accès à ce fichier (c:\Wamp\Apache!\) et vous pouvez le modifier avec un éditeur de 
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texte (attention à ne modifier que ce qui est nécessaire). En revanche, si vous êtes chez un hébergeur, vous n'y 
avez pas accès. Généralement, par défaut, l'hébergeur peut avoir activé cette fonctionnalité : pour le vérifier, copier 
une image sur votre site, et essayez de l'afficher en modifiant sa taille). Si ce n'est pas le cas, envoyez-lui un 
courrier pour savoir si cela est possible. 


Cherchez la ligne : 


;extension=php gd2.d11 


supprimez le point virgule puis enregistrez. 
Vous pouvez maintenant copier des images sur votre site, et les afficher avec les dimensions que vous souhaitez. 


Pour modifier la taille limite 


$SwgMaxUploadsSize 


Pour modifier la valeur limite pour le message d'avertissement 


$wgUploadSizeWarning 


Astuce pour les administrateurs : Pour permettre le téléchargement de fichiers, l'administrateur du wiki doit éditer le fichier 
LocalSettings.php et décommenter l'option $wgEnableUploads = true;.Les fichiers téléchargés seront stockés dans 

W le répertoire des images spécifié par la variable $wgUploadPath dans le fichier LocalSettings.php. Ce répertoire doit 
être autorisé en écriture si le téléchargement de fichiers est activé. Les paramètres de configuration $wgUploadPath et 
$wgUploadDirectory décrivent les paramètres de configuration des téléchargements. 


Configurer le niveau d'accès à votre wiki [modifier le wikicode] 


Par défaut, toute personne accédant à votre wiki est en mesure d'en modifier les pages, sauf certaines pages 
protégées par le logiciel ou par vous. 


La configuration de base de l'accès à votre wiki se fait par la modification du fichier LocalSettings.php avec un 
éditeur gratuit et libre comme NotePad++ (mais pas le Bloc-notes, ni WordPad). 


D'autres configurations sont possibles, mais elles sont plus complexes à mettre en œuvre et nous les aborderons 
plus loin dans ce livre. 
Déterminer qui peut éditer ou voir votre wiki [modifier le wikicode] 


Afin d'exclure de l'édition les utilisateurs non enregistrés, éditez votre fichier LocalSettings.php avec NotePad++, et 
ajoutez les lignes suivantes : 


# Qui peut éditer : false signifie que seuls les utilisateurs enregistrés peuvent éditer. 
SwgGroupPermissions{['*']['edit'] = false; 


Afin d'interdire la visualisation de votre wiki, sauf les pages d'Accueil et d'inscription, aux personnes non 
enregistrées, éditez votre fichier LocalSettings.php avec NotePad++, et ajoutez les lignes suivantes : 


# Pages que les utilisateurs non enregistrés peuvent voir 
SwgWhitelistRead = array( "Accueil", "Special:Userlogin" ); 
$SwgGroupPermissions['*']['read'] = false; 


Configurer l'apparence [modifier le wikicode] 


Changer le logo [modifier le wikicode] 


Dans le fichier LocalSettings.php, avec NotePad++, à la ligne 50 il faut modifier l'image : 


SwgLogo = "SwgStylePath/skins/common/images/wiki.png"; 


Cette image se trouve dans le répertoire /skins/common/images/ et mesure 135x135 pixels. Il suffit de télécharger 
une nouvelle image du même format et de modifier la ligne $wgLogo. 


Changer le fond [modifier le wikicode] 


La configuration du fond de votre wiki va se faire à partir de votre site, par la modification de la page 
MediaWiki:Monobook.css. Cette page permet de modifier de nombreux éléments de l'affichage. Vous ne pouvez la 
modifier qu'en tant qu'administrateur du site, car elle fait partie des pages que MediaWiki protège à l'installation. 
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body 
{ 


background: white; 


Ceci permet l'affichage d'un fond blanc. 


body 


background: rgb(238, 255, 238) url(adresse de l'image de fond) repeat; 


En plaçant l'adresse d'un motif entre les parenthèses, il vous servira de fond en arrière-plan. 


Personnaliser les couleurs [modifier le wikicode] 
Personnaliser la boîte de navigation [modifier le wikicode] 


Astuce pour les administrateurs : Vous pouvez personnaliser les liens de navigation via Special:Almessages. Par 
>" exemple, éditez VediaWiki:Sitesupport (nom affiché) et VediaWiki:Sitesupport-url (page de destination). Ou créez votre 
propre menu dans MediaWiki:Sidebar. 


La boîte de navigation est une boîte située à gauche de l'écran, et dans laquelle on trouve des liens généraux ou 
particuliers qui, spécialement placés à cet endroit, sont accessibles depuis n'importe quelle page de votre wiki. Il est 
donc important de la configurer, puisque les liens que vous y placerez peuvent être adaptés à votre projet. Par 
exemple, si vous créez un index (pour des livres, des sites, etc.), il est pratique de pouvoir accéder directement à 
celui-ci par un lien toujours affiché à l'écran. 


Cette boîte est modifiable sur votre wiki personnel à partir de la page nommée MediaWiki:Sidebar qui se trouve sur 
votre wiki personnel. Vous ne pouvez la modifier qu'en tant qu'administrateur. 


Par défaut, le contenu de cette boîte est le suivant : 


* navigation 

** mainpage |mainpage 

++ portal-url|portal 
“Ncurrentevents_.url|currentevents 
** recentchanges-url|recentchanges 
** randompage-url | randompage 

** helppage|help 

** sitesupport-url|sitesupport 


Ajouter une annonce en haut de toutes les pages [modifier le wikicode] 
Il suffit simplement d'ajouter le texte désiré à la variable $wgSiteNotice dans le fichier LocalSettings.php. 


ll faudra ensuite configurer les fichiers .css situés dans le dossier skin si vous désirez changer l'apparence de ce 
texte. 


Pour aller plus loin [modifier le wikicode] 


e Personnaliser son monobook, niveau simple (placez les codes prévus pour les monobooks personnels dans les 
monobooks de votre wiki pour que la configuration s'étende à tout votre site). 

e Fonctions avancées, niveau plus élevé 

e La configuration du fichier LocalSettings.php (en anglais) 

e Liste de sites utilisant MediaWiki 


Catégorie : MediaWiki pour débutants (livre) 
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